home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 076-100 / scopedisk97 / rgbex / rgbexchange.man < prev    next >
Text File  |  1995-03-19  |  19KB  |  550 lines
  1.                                   COPYRIGHT NOTICE
  2.  
  3.                  RGBExchange and all Conversion Modules, Programs and
  4.                documentation Copyright (C) 1989, 1990 by Troy Barlow. 
  5.                                 All Rights Reserved.
  6.                                    by Troy Barlow
  7.            
  8.             *  A $20 shareware contribution is  requested  for using the
  9.                program.
  10.             *  The author retains the sole right to sell the program.
  11.             *  The author grants users the right to copy and distribute
  12.                the program within the following constraints:
  13.                  - All program files remain unaltered and are distributed
  14.                    in the original zoo archive.
  15.                  - Only the original version of the program with the
  16.                    SHAREWARE message and Author Address is distributed.
  17.                  - No attempt is made to sell the program, or to make
  18.                    money from it or any modified version of it.
  19.                  - The program is not bundled with any other hardware or
  20.                    software transactions without the author's written
  21.                    permission.
  22.                  - Recognized  users' groups may charge a maximum  $5
  23.                    duplication or distribution fee.
  24.             *  Continued use of the program (more  than 2  weeks) by  any
  25.                individual, corporation or institution without a single
  26.                user license is prohibited.
  27.             *  Single user licenses are obtained by  sending  in the  $20
  28.                shareware contribution to:
  29.  
  30.                                     Troy Barlow
  31.                                     P.O. BOX 174
  32.                                   South Amboy, N.J.
  33.                                        08879
  34.  
  35.                                    - DISCLAIMER -
  36.  
  37.              The author disclaims all warranties expressed or implied as
  38.           to the  quality or performance of this program. The author will
  39.           not be held liable for any lost profits, lost savings or any
  40.           other  direct, indirect,  incidental   or  consequential damages
  41.           resulting from the use of this program.  Your  use of this
  42.           program constitutes your agreement to this disclaimer and your
  43.           release of  the author from any form  of  liability  or
  44.           litigation.
  45.  
  46.              RGBExchange and all RGBExchange Conversion Modules are
  47.           trademarks of Troy Barlow. Sculpt Animate 3D and 4D are
  48.           trademarks of the Byte by Byte Corporation. Targa 16, 24 and 32
  49.           are trademarks of Truevision, Inc. Turbo Silver is a trademark
  50.           of Impulse, Inc. DigiView 2.0 and 3.0 are trademarks of NewTek,
  51.           Inc. FrameGrabber is a trademark of Progressive Peripherals and
  52.           Software. AmigaDOS, Amiga Kickstart, and Workbench are
  53.           trademarks of Commodore Amiga, Inc.
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.                                      Introduction
  68.  
  69.             Welcome to RGBExchange, the Full Color Image conversion
  70.           program for the Amiga. RGBExchange offers you the ability to
  71.           convert RGB images between popular Amiga and IBM image formats.
  72.           Some of its advantages are:
  73.  
  74.           - Easy to use interface
  75.           - Fast conversion times
  76.           - Scale size of image if needed  
  77.           - Support of 68020/030 included
  78.           - Change the amount of colors in the image
  79.  
  80.             Conversions currently supported:
  81.            
  82.           - DigiView 2.0/3.0 Full Color 21 bitplane images
  83.           - Turbo Silver 2.0/3.0 Full Color 12 bitplane images
  84.           - Turbo Silver 2.0/3.0 Full Color 24 bitplane images
  85.           - Targa Truevision full color ICB 16 bitplane image
  86.           - Targa Truevision full color 16 bitplane image
  87.           - Targa Truevision full color 24 bitplane image
  88.           - Progressive Peripherals Frame Grabber full color 24 bitplane
  89.           - Sculpt Animate 3D/4D full color 24 bitplane image
  90.  
  91.             Converters coming soon (Depending on the success of this
  92.             version!) :
  93.           - Targa Truevision/Vista full color 32 bitplane image
  94.           - IFF ( Including IBM Deluxe Paint II 256 color IFF )
  95.           - ColorEyes
  96.           - GIF
  97.           - Image processing module
  98.  
  99.           and more!
  100.  
  101.  
  102.           Hardware Requirements:
  103.  
  104.           RGBExchange
  105.  
  106.           Amiga 500, 1000 or 2000
  107.           512k memory minimum ( 1 meg or more recommended )
  108.           1 floppy drive minimum ( Hard Drive recommended )
  109.  
  110.  
  111.           RGBExchangeF
  112.  
  113.           Amiga 500, 1000 or 2000
  114.           68000, 68020 or 68030 CPU
  115.           512k memory minimum ( 1 meg or more recommended )
  116.           1 floppy drive minimum ( Hard Drive recommended )
  117.  
  118.  
  119.           SPECIAL NOTE ABOUT RAM:
  120.             Some conversions require a large amount of memory and can't be
  121.           done on a 512k machine. To calculate approximately how much ram
  122.           you will need, use this formula:
  123.  
  124.                              IMAGE WIDTH * IMAGE HEIGHT * 3
  125.  
  126.           Example: FROM 512 * 400 / 24 bits TO 320 * 200/24 bits will
  127.           require 614,400 bytes of ram plus program overhead.
  128.  
  129.  
  130.  
  131.  
  132.  
  133.                                    Getting Started
  134.  
  135.             Start up your Amiga with Kickstart and or Workbench 1.2 or
  136.           higher. If you have problems please refer to your Amiga Users
  137.           Guide.
  138.  
  139.              Place your RGBExchange disk into any drive and when the
  140.           RGBExchange disk icon appears, open it and you will see two
  141.           draws appear. If you have a 68020 or a 68030 board installed
  142.           open the RGBExchangeF draw, otherwise open the RGBExchange draw.
  143.           RGBExchangeF is functionally the same as RGBExchange, only
  144.           RGBExchange is for a 68000 ( stock ) Amiga. RGBExchangeF is ONLY
  145.           for 68020/68030 equipped Amigas. Therefore when this document
  146.           refers to RGBExchange, it also applies to RGBExchangeF. The same
  147.           applies with the conversion modules themselves, if they have a
  148.           'F' at the end of the name they are 020/030 versions.
  149.  
  150.             Once the draw is opened you will see the RGBExchange program
  151.           icon and icons for the actual conversion modules. Double click
  152.           the RGBExchange icon to start RGBExchange. Once its running, you
  153.           will see a window appear at the bottom of your Workbench screen.
  154.           This window is the main control panel for RGBExchange. On it you
  155.           will find 2 sets of gadgets, one for the source image and one
  156.           for the destination image. In most cases you will be dealing
  157.           only with these gadgets to perform the image conversions. These
  158.           gadgets can be changed by simply clicking on them. Note that all
  159.           gadgets on the left side of the window are the SOURCE gadgets.
  160.           All gadgets on the right side of the window are DESTINATION
  161.           gadgets. They are divided by the RGBExchange name banner in the
  162.           center on the window. Here is a description of each gadget and
  163.           its use starting with the SOURCE ( left ) side:
  164.  
  165.           - FROM   Clicking to the right of this will cycle through the
  166.                   module names that are currently running. The name that
  167.                   is left in this gadget will be used as the source image
  168.                   format ( The image that will be loaded ).
  169.  
  170.           - TYPE   ( Under the FROM gadget )  Clicking this gadget will
  171.                   cycle through the types of images that the module name
  172.                   in FROM supports. PLEASE SEE NOTE BELOW for more
  173.                   information on this and other source gadgets.
  174.  
  175.           - PLANES  Clicking this gadget will cycle through the amount of
  176.                   planes supported by the current TYPE. And is used to set
  177.                   amount of SOURCE bitplanes for this conversion.
  178.  
  179.           - COMPRESS Clicking this will toggle compression ON/OFF for the
  180.                   SOURCE image if the current type supports variable
  181.                   compression.
  182.  
  183.           - WIDTH   Clicking this will cycle through the image widths 
  184.                   available with the current SOURCE type.
  185.  
  186.           - HEIGHT  Clicking this will cycle through the image heights
  187.                   available with the current SOURCE type.
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.           NOTE!:   Most of the format's have information in the file that
  202.                  will tell RGBExchange the TYPE, BITPLANES, COMPRESSION
  203.                  WIDTH and HEIGHT of the source image as soon as the
  204.                  conversion is started. If this is the case, SOURCE
  205.                  gadgets will automatically be updated during the
  206.                  conversion and do not need to be set by you. Currently,
  207.                  the only format that requires you to set the SOURCE
  208.                  gadgets is Sculpt/Animate 3D/4D.
  209.                  
  210.                   Also, although RGBExchange allows you to cycle WIDTH
  211.                  and HEIGHT separatly, some formats don't support all
  212.                  possibilities ( Example: 704 * 200 ). So please refer
  213.                  to the list of formats at the end of this document for
  214.                  more information.
  215.  
  216.  
  217.           The DESTINATION ( left ) side:
  218.  
  219.           NOTE!:   Unlike the SOURCE side, ALL these gadgets need to be
  220.                   set for a successful conversion.
  221.                 
  222.           - TO     Clicking to the right of this will also cycle through
  223.                   the module names that are currently running. But the
  224.                   name that is left in this gadget will be used as the
  225.                   destination format ( The image that we will convert and
  226.                   save as ).
  227.  
  228.           - TYPE   ( Under the TO gadget )  Clicking this gadget will
  229.                 cycle through the types of images that the module name
  230.                   in TO supports. 
  231.  
  232.           - PLANES  Clicking this gadget will cycle through the amount of
  233.                   planes supported by the current TYPE. And is used to set
  234.                   amount of DESTINATION bitplanes for this conversion.
  235.  
  236.           - COMPRESS Clicking this will toggle compression ON/OFF for the
  237.                   DESTINATION image if the current type supports variable
  238.                   compression.
  239.  
  240.           - WIDTH   Clicking this will cycle through the image widths 
  241.                   available with the current DESTINATION type.
  242.  
  243.           - HEIGHT  Clicking this will cycle through the image heights
  244.                   available with the current DESTINATION type.
  245.  
  246.              RGBExchange also has the following MENU selections.
  247.  
  248.           The PROJECT menu:
  249.  
  250.           - ABORT   This will abort the current conversion. Note that this
  251.                   may not happen immediately.
  252.  
  253.           - CONVERT  This will start the conversion process by asking you
  254.                   for the SOURCE/DESTINATION filenames. It will then tell
  255.                   the modules that are involved in the conversion to get
  256.                   started.
  257.  
  258.           - QUIT     This will terminate RGBExchange and all the modules
  259.                   that are running. Note that this has no effect during a
  260.                   conversion.
  261.  
  262.  
  263.  
  264.  
  265.  
  266.           The SPECIAL menu:
  267.  
  268.           - CLIPIT   This tells the modules not to resize the image during
  269.                   the conversion. Instead, you want to CLIP a region the
  270.                   size of SOURCE WIDTH * HEIGHT from the top left side of
  271.                   the image. If the image you are converting to is larger
  272.                   then the source image, this is impossible, and the
  273.                   program will resize anyway.
  274.  
  275.           - RESIZE   ( Default ) This tells the modules that you want
  276.               to resize the image using a averaging algorithm if the
  277.               image needs to be resized.
  278.  
  279.             Now you should go back into the draw on the Workbench screen
  280.           where you found the RGBExchange and Conversion Module icons.
  281.           After you decide what modules you will need for the desired
  282.           conversion, you need to run them also. You do this by double
  283.           clicking on them just as you did with RGBExchange. Note that the
  284.           conversion don't have to be from one format to another. You can
  285.           convert a image back to the same format it started out as. This
  286.           can be done to reduce the colors or the size of the image etc.
  287.           If this is the case, you only need to run the needed Conversion
  288.           Module once. If you try to run any module that's already
  289.           running, you will be notified in the RGBExchange status window.
  290.           Also, Conversion Modules are not stand alone programs and can't
  291.           run without RGBExchange. 
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.                                Starting the conversion
  332.  
  333.  
  334.             After you have started the Module(s) needed, you must now set
  335.           up the gadgets ( following the guidelines above ) in the
  336.           RGBExchange main panel. Be sure to set all the DESTINATION
  337.           gadgets to the settings you wish to convert to, and set up the
  338.           FROM gadget on the SOURCE side along with any other SOURCE
  339.           gadgets you may need. Remember, some formats don't require you
  340.           to set up the SOURCE gadgets except the FROM gadget. Refer to
  341.           the above explanation and the end of this document for more
  342.           information on the currently available formats.
  343.  
  344.             Be sure to set the resize option ( under the SPECIAL MENU )
  345.           that you want to use if needed. Now select CONVERT from the
  346.           project menu. A window will appear asking you to enter the
  347.           filename(s) for the SOURCE image. Some formats, like
  348.           Sculpt/Animate, require 3 filenames. After you are finished with
  349.           the source image name(s), you will be asked to enter destination
  350.           filenames ( note that you can cancel at any time by clicking on
  351.           the CANCEL gadget in the requester ). As soon as you are done
  352.           with the destination filename(s), the conversion will start. You
  353.           can watch the status window for reports on the progress of the
  354.           conversion, and you will be notified here when the conversion is
  355.           complete ( finished saving ). 
  356.  
  357.             You may abort at any time by selecting abort in the project
  358.           menu. Note that some conversions can take a while! It all
  359.           depends on if the module needs to resize or convert bitplanes
  360.           during a conversion. In testing, the 68000 version will average
  361.           2.5 minutes for a conversion, while the 020/030 version will do
  362.           it in 1 or fewer minutes. I can not give exact times because it
  363.           depends on the conversion settings and/or the formats you
  364.           selected.
  365.  
  366.              When the conversion is complete, you can either go on and
  367.           convert other pictures, or terminate RGBExchange. To terminate
  368.           RGBExchange you can select QUIT from the project menu, or click
  369.           on the RGBExchange window's close gadget. To terminate modules,
  370.           you may also click their close gadget's if they are not in a
  371.           conversion ( when you quit from RGBExchange, all modules are
  372.           automatically shut down for you ).
  373.  
  374.           ENJOY!
  375.  
  376.           REMEMBER: Future versions of this program depend on how many
  377.           people register this version. SHAREWARE is NOT FREE software!
  378.           Registered users will receive a registered copy of this
  379.           program by mail if you don't forget to include your name and
  380.           address when you send in the $20. You will also be notified
  381.           by mail of any future versions of RGBExchange.
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.                           Conversion Module Specifications
  398.  
  399.           Turbo Silver Conversion Module.
  400.           Types supported:
  401.           RGBN   =  12 bits per pixel ( 4096 possible colors )
  402.           RGB8   =  24 bits per pixel ( 16,777,216 possible colors )
  403.  
  404.           Compressed = YES
  405.  
  406.                   WIDTHS           HEIGHTS
  407.                     320               200
  408.                     352               220
  409.                     640               400
  410.                     704               440
  411.           ----------------------------------------------------------------
  412.           Targa  Conversion Module.
  413.  
  414.           Types supported:
  415.           ICB = Image Capture Board 
  416.                 type 2 (uncompressed RGB) or 10 (compressed RGB)
  417.                 16 bits per pixel ( 32,768 possible colors )
  418.                 
  419.                 WIDTHS             HEIGHTS
  420.                   256                 200
  421.  
  422.           TV16 = Targa type 2 (uncompressed RGB) or 10 (compressed RGB)
  423.                  16 bits per pixel ( 32,768 possible colors )
  424.                 
  425.                 WIDTHS             HEIGHTS
  426.                   512                 400
  427.                                       482
  428.  
  429.           TV24 = Targa type 2 (uncompressed RGB) or 10 (compressed RGB)
  430.                  24 bits per pixel ( 16,777,216 possible colors )
  431.  
  432.                 WIDTHS             HEIGHTS
  433.                   512                 400
  434.                                       482
  435.  
  436.           Compressed: YES/NO
  437.           ----------------------------------------------------------------
  438.           Digi-View 2.0/3.0 Conversion Module
  439.  
  440.           Types supported:
  441.           DGVW = DigiView RGB files 
  442.                  21 bits per pixel ( 2,097,152 possible colors )
  443.  
  444.           Compressed: YES
  445.  
  446.                 WIDTHS             HEIGHTS
  447.                   320                 200
  448.                   352                 240
  449.                   384                 400
  450.                   640                 480
  451.                   704
  452.                   768
  453.  
  454.  
  455.           ----------------------------------------------------------------
  456.           Frame Grabber Conversion Module
  457.  
  458.           Types supported:
  459.           IMG8 = Full color 
  460.                  24 bits per pixel ( 16,777,216 possible colors )
  461.  
  462.           Compressed: YES
  463.  
  464.                 WIDTHS             HEIGHTS
  465.                   320                 200
  466.                   384                 240
  467.                   640                 400
  468.           ----------------------------------------------------------------
  469.           Sculpt/Animate Conversion Module
  470.  
  471.           Types supported:
  472.  
  473.           RGB = Full color RAW
  474.                 24 bits per pixel ( 16,777,216 possible colors )
  475.  
  476.           Compressed: NO
  477.  
  478.                 WIDTHS             HEIGHTS
  479.                   320                 200
  480.                   352                 220
  481.                   640                 240
  482.                   704                 400
  483.                                       440
  484.                                       480
  485.                 
  486.              
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.